<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkList</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
<link rel="home" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkItemFactory.html" title="GtkItemFactory">
<link rel="next" href="GtkListItem.html" title="GtkListItem">
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="Builder.html" title="Interface builder">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="chapter" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder">
<link rel="chapter" href="gtk-migrating-tooltips.html" title="Migrating from GtkTooltips to GtkTooltip">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="api-index-full.html" title="Index of all symbols">
<link rel="index" href="api-index-deprecated.html" title="Index of deprecated symbols">
<link rel="index" href="api-index-2-2.html" title="Index of new symbols in 2.2">
<link rel="index" href="api-index-2-4.html" title="Index of new symbols in 2.4">
<link rel="index" href="api-index-2-6.html" title="Index of new symbols in 2.6">
<link rel="index" href="api-index-2-8.html" title="Index of new symbols in 2.8">
<link rel="index" href="api-index-2-10.html" title="Index of new symbols in 2.10">
<link rel="index" href="api-index-2-12.html" title="Index of new symbols in 2.12">
<link rel="index" href="api-index-2-14.html" title="Index of new symbols in 2.14">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkItemFactory.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkListItem.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#GtkList.synopsis" class="shortcut">Top</a>
                 | 
                <a href="#GtkList.description" class="shortcut">Description</a>
                 | 
                <a href="#GtkList.object-hierarchy" class="shortcut">Object Hierarchy</a>
                 | 
                <a href="#GtkList.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
                 | 
                <a href="#GtkList.properties" class="shortcut">Properties</a>
                 | 
                <a href="#GtkList.signals" class="shortcut">Signals</a>
</td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkList"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkList.top_of_page"></a>GtkList</span></h2>
<p>GtkList — Widget for packing a list of selectable items</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GtkList.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">

#include &lt;gtk/gtk.h&gt;

                    <a class="link" href="GtkList.html#GtkList-struct" title="GtkList">GtkList</a>;
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a class="link" href="GtkList.html#gtk-list-new" title="gtk_list_new ()">gtk_list_new</a>                        (void);
void                <a class="link" href="GtkList.html#gtk-list-insert-items" title="gtk_list_insert_items ()">gtk_list_insert_items</a>               (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *items,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> position);
void                <a class="link" href="GtkList.html#gtk-list-append-items" title="gtk_list_append_items ()">gtk_list_append_items</a>               (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *items);
void                <a class="link" href="GtkList.html#gtk-list-prepend-items" title="gtk_list_prepend_items ()">gtk_list_prepend_items</a>              (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *items);
void                <a class="link" href="GtkList.html#gtk-list-remove-items" title="gtk_list_remove_items ()">gtk_list_remove_items</a>               (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *items);
void                <a class="link" href="GtkList.html#gtk-list-remove-items-no-unref" title="gtk_list_remove_items_no_unref ()">gtk_list_remove_items_no_unref</a>      (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *items);
void                <a class="link" href="GtkList.html#gtk-list-clear-items" title="gtk_list_clear_items ()">gtk_list_clear_items</a>                (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> start,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> end);
void                <a class="link" href="GtkList.html#gtk-list-select-item" title="gtk_list_select_item ()">gtk_list_select_item</a>                (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> item);
void                <a class="link" href="GtkList.html#gtk-list-unselect-item" title="gtk_list_unselect_item ()">gtk_list_unselect_item</a>              (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> item);
void                <a class="link" href="GtkList.html#gtk-list-select-child" title="gtk_list_select_child ()">gtk_list_select_child</a>               (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);
void                <a class="link" href="GtkList.html#gtk-list-unselect-child" title="gtk_list_unselect_child ()">gtk_list_unselect_child</a>             (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                <a class="link" href="GtkList.html#gtk-list-child-position" title="gtk_list_child_position ()">gtk_list_child_position</a>             (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);
void                <a class="link" href="GtkList.html#gtk-list-set-selection-mode" title="gtk_list_set_selection_mode ()">gtk_list_set_selection_mode</a>         (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkSelectionMode" title="enum GtkSelectionMode">GtkSelectionMode</a> mode);
void                <a class="link" href="GtkList.html#gtk-list-extend-selection" title="gtk_list_extend_selection ()">gtk_list_extend_selection</a>           (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType">GtkScrollType</a> scroll_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"
>gfloat</a> position,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> auto_start_selection);
void                <a class="link" href="GtkList.html#gtk-list-start-selection" title="gtk_list_start_selection ()">gtk_list_start_selection</a>            (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);
void                <a class="link" href="GtkList.html#gtk-list-end-selection" title="gtk_list_end_selection ()">gtk_list_end_selection</a>              (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);
void                <a class="link" href="GtkList.html#gtk-list-select-all" title="gtk_list_select_all ()">gtk_list_select_all</a>                 (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);
void                <a class="link" href="GtkList.html#gtk-list-unselect-all" title="gtk_list_unselect_all ()">gtk_list_unselect_all</a>               (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);
void                <a class="link" href="GtkList.html#gtk-list-scroll-horizontal" title="gtk_list_scroll_horizontal ()">gtk_list_scroll_horizontal</a>          (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType">GtkScrollType</a> scroll_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"
>gfloat</a> position);
void                <a class="link" href="GtkList.html#gtk-list-scroll-vertical" title="gtk_list_scroll_vertical ()">gtk_list_scroll_vertical</a>            (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType">GtkScrollType</a> scroll_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"
>gfloat</a> position);
void                <a class="link" href="GtkList.html#gtk-list-toggle-add-mode" title="gtk_list_toggle_add_mode ()">gtk_list_toggle_add_mode</a>            (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);
void                <a class="link" href="GtkList.html#gtk-list-toggle-focus-row" title="gtk_list_toggle_focus_row ()">gtk_list_toggle_focus_row</a>           (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);
void                <a class="link" href="GtkList.html#gtk-list-toggle-row" title="gtk_list_toggle_row ()">gtk_list_toggle_row</a>                 (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *item);
void                <a class="link" href="GtkList.html#gtk-list-undo-selection" title="gtk_list_undo_selection ()">gtk_list_undo_selection</a>             (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);
void                <a class="link" href="GtkList.html#gtk-list-end-drag-selection" title="gtk_list_end_drag_selection ()">gtk_list_end_drag_selection</a>         (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkList.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
   +----<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
                           +----GtkList
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkList.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkList implements
 AtkImplementorIface and  <a class="link" href="gtk-gtkbuildable.html#GtkBuildable">GtkBuildable</a>.</p>
</div>
<div class="refsect1" lang="en">
<a name="GtkList.properties"></a><h2>Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkList.html#GtkList--selection-mode" title='The "selection-mode" property'>selection-mode</a>"           <a class="link" href="gtk-Standard-Enumerations.html#GtkSelectionMode" title="enum GtkSelectionMode">GtkSelectionMode</a>      : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkList.signals"></a><h2>Signals</h2>
<pre class="synopsis">
  "<a class="link" href="GtkList.html#GtkList-select-child" title='The "select-child" signal'>select-child</a>"                                   : Run First
  "<a class="link" href="GtkList.html#GtkList-selection-changed" title='The "selection-changed" signal'>selection-changed</a>"                              : Run First
  "<a class="link" href="GtkList.html#GtkList-unselect-child" title='The "unselect-child" signal'>unselect-child</a>"                                 : Run First
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkList.description"></a><h2>Description</h2>
<p>
The <a class="link" href="GtkList.html" title="GtkList"><span class="type">GtkList</span></a> widget is a container whose children are displayed
vertically in order, and can be selected.
The list has many selection modes, which are programmer selective and
depend on how many elements are able to be selected at the same time.
</p>
<p>
GtkList has been deprecated since GTK+ 2.0 and should not be used
in newly written code. Use <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a> instead.
</p>
</div>
<div class="refsect1" lang="en">
<a name="GtkList.details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="GtkList-struct"></a><h3>GtkList</h3>
<pre class="programlisting">typedef struct _GtkList GtkList;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkList</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-new"></a><h3>gtk_list_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_list_new                        (void);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_new</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Creates a new <a class="link" href="GtkList.html" title="GtkList"><span class="type">GtkList</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the newly-created <a class="link" href="GtkList.html" title="GtkList"><span class="type">GtkList</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-insert-items"></a><h3>gtk_list_insert_items ()</h3>
<pre class="programlisting">void                gtk_list_insert_items               (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *items,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> position);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_insert_items</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Inserts <em class="parameter"><code>items</code></em> into the <em class="parameter"><code>list</code></em> at the position <em class="parameter"><code>position</code></em>. The <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> items
must not be freed after.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>items</code></em> :</span></p></td>
<td>the items.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>the position to insert <em class="parameter"><code>items</code></em>, starting at 0.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-append-items"></a><h3>gtk_list_append_items ()</h3>
<pre class="programlisting">void                gtk_list_append_items               (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *items);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_append_items</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Adds <em class="parameter"><code>items</code></em> to the end of the <em class="parameter"><code>list</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>items</code></em> :</span></p></td>
<td>the items.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-prepend-items"></a><h3>gtk_list_prepend_items ()</h3>
<pre class="programlisting">void                gtk_list_prepend_items              (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *items);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_prepend_items</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Inserts <em class="parameter"><code>items</code></em> at the beginning of the <em class="parameter"><code>list</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>items</code></em> :</span></p></td>
<td>the items.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-remove-items"></a><h3>gtk_list_remove_items ()</h3>
<pre class="programlisting">void                gtk_list_remove_items               (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *items);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_remove_items</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Removes the <em class="parameter"><code>items</code></em> from the <em class="parameter"><code>list</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>items</code></em> :</span></p></td>
<td>the items to remove.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-remove-items-no-unref"></a><h3>gtk_list_remove_items_no_unref ()</h3>
<pre class="programlisting">void                gtk_list_remove_items_no_unref      (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a> *items);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_remove_items_no_unref</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Removes the <em class="parameter"><code>items</code></em> from the <em class="parameter"><code>list</code></em>, without unreferencing them. It
may be useful if you want to move the items from one list to another.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>items</code></em> :</span></p></td>
<td>the items.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-clear-items"></a><h3>gtk_list_clear_items ()</h3>
<pre class="programlisting">void                gtk_list_clear_items                (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> start,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> end);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_clear_items</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Removes the items between index <em class="parameter"><code>start</code></em> (included) and <em class="parameter"><code>end</code></em> (excluded)
from the <em class="parameter"><code>list</code></em>. If <em class="parameter"><code>end</code></em> is negative, or greater than the number of
children of <em class="parameter"><code>list</code></em>, it's assumed to be exactly the number of
elements. If <em class="parameter"><code>start</code></em> is greater than or equal to <em class="parameter"><code>end</code></em>, nothing is
done.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td>
<td>the index of the first item to remove.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
<td>the index of the lest item to remove plus one.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-select-item"></a><h3>gtk_list_select_item ()</h3>
<pre class="programlisting">void                gtk_list_select_item                (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> item);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_select_item</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Selects the child number <em class="parameter"><code>item</code></em> of the <em class="parameter"><code>list</code></em>. Nothing happens if <em class="parameter"><code>item</code></em>
is out of bounds. The signal GtkList::select-child will be emitted.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
<td>the index of the child to select.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-unselect-item"></a><h3>gtk_list_unselect_item ()</h3>
<pre class="programlisting">void                gtk_list_unselect_item              (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> item);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_unselect_item</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Unselects the child number <em class="parameter"><code>item</code></em> of the <em class="parameter"><code>list</code></em>. Nothing happens if
<em class="parameter"><code>item</code></em> is out of bounds. The signal GtkList::unselect-child will be
emitted.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
<td>the index of the child to unselect.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-select-child"></a><h3>gtk_list_select_child ()</h3>
<pre class="programlisting">void                gtk_list_select_child               (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_select_child</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Selects the given <em class="parameter"><code>child</code></em>. The signal GtkList::select-child will be
emitted.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>the child to select.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-unselect-child"></a><h3>gtk_list_unselect_child ()</h3>
<pre class="programlisting">void                gtk_list_unselect_child             (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_unselect_child</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Unselects the given <em class="parameter"><code>child</code></em>. The signal GtkList::unselect-child will be
emitted.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>the child to unselect.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-child-position"></a><h3>gtk_list_child_position ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_list_child_position             (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_child_position</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Searches the children of <em class="parameter"><code>list</code></em> for the index of <em class="parameter"><code>child</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>the child to look for.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the index of the child, -1 if not found.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-set-selection-mode"></a><h3>gtk_list_set_selection_mode ()</h3>
<pre class="programlisting">void                gtk_list_set_selection_mode         (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkSelectionMode" title="enum GtkSelectionMode">GtkSelectionMode</a> mode);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_set_selection_mode</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Set the list selection mode. The selection mode can be any value in
<span class="type">""</span>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-SINGLE--CAPS"><span class="type">GTK_SELECTION_SINGLE</span></a></span></p></td>
<td><p>
Zero or one element may be selected.
</p></td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-BROWSE--CAPS"><span class="type">GTK_SELECTION_BROWSE</span></a></span></p></td>
<td><p>
Exactly one element is always selected (this can be false after you have
changed the selection mode).
</p></td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-MULTIPLE--CAPS"><span class="type">GTK_SELECTION_MULTIPLE</span></a></span></p></td>
<td><p>
Any number of elements may be selected. Clicks toggle the state of an
item.
</p></td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-EXTENDED--CAPS"><span class="type">GTK_SELECTION_EXTENDED</span></a></span></p></td>
<td><p>
Any number of elements may be selected. Click-drag selects a range of
elements; the Ctrl key may be used to enlarge the selection, and
Shift key to select between the focus and the child pointed to.
</p></td>
</tr>
</tbody>
</table></div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
<td>the new selection mode.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-extend-selection"></a><h3>gtk_list_extend_selection ()</h3>
<pre class="programlisting">void                gtk_list_extend_selection           (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType">GtkScrollType</a> scroll_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"
>gfloat</a> position,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> auto_start_selection);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_extend_selection</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Extends the selection by moving the anchor according to <em class="parameter"><code>scroll_type</code></em>. Only
in <a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-EXTENDED--CAPS"><span class="type">GTK_SELECTION_EXTENDED</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>scroll_type</code></em> :</span></p></td>
<td>the direction and length.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>the position if <em class="parameter"><code>scroll_type</code></em> is <span class="type">GTK_SCROLL_JUMP</span>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>auto_start_selection</code></em> :</span></p></td>
<td>if <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a>, <a class="link" href="GtkList.html#gtk-list-start-selection" title="gtk_list_start_selection ()"><code class="function">gtk_list_start_selection()</code></a> is automatically
carried out before extending the selection.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-start-selection"></a><h3>gtk_list_start_selection ()</h3>
<pre class="programlisting">void                gtk_list_start_selection            (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_start_selection</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Starts a selection (or part of selection) at the focused child. Only in
<a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-EXTENDED--CAPS"><span class="type">GTK_SELECTION_EXTENDED</span></a> mode.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-end-selection"></a><h3>gtk_list_end_selection ()</h3>
<pre class="programlisting">void                gtk_list_end_selection              (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_end_selection</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Ends the selection. Used with <a class="link" href="GtkList.html#gtk-list-extend-selection" title="gtk_list_extend_selection ()"><code class="function">gtk_list_extend_selection()</code></a> and
<a class="link" href="GtkList.html#gtk-list-start-selection" title="gtk_list_start_selection ()"><code class="function">gtk_list_start_selection()</code></a>. Only in <a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-EXTENDED--CAPS"><span class="type">GTK_SELECTION_EXTENDED</span></a> mode.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-select-all"></a><h3>gtk_list_select_all ()</h3>
<pre class="programlisting">void                gtk_list_select_all                 (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_select_all</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Selects all children of <em class="parameter"><code>list</code></em>. A signal will be emitted for each
newly selected child.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-unselect-all"></a><h3>gtk_list_unselect_all ()</h3>
<pre class="programlisting">void                gtk_list_unselect_all               (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_unselect_all</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Unselects all children of <em class="parameter"><code>list</code></em>. A signal will be emitted for each
newly unselected child.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-scroll-horizontal"></a><h3>gtk_list_scroll_horizontal ()</h3>
<pre class="programlisting">void                gtk_list_scroll_horizontal          (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType">GtkScrollType</a> scroll_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"
>gfloat</a> position);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_scroll_horizontal</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Scrolls <em class="parameter"><code>list</code></em> horizontaly. This supposes that the list is packed into a
scrolled window or something similar, and adjustments are well
set. Step and page increment are those from the horizontal adjustment
of <em class="parameter"><code>list</code></em>. Backward means to the left, and forward to the
right. Out of bounds values are truncated.
<em class="parameter"><code>scroll_type</code></em> may be any valid <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a>. If <em class="parameter"><code>scroll_type</code></em> is
<span class="type">GTK_SCROLL_NONE</span>, nothing is done. If it's <span class="type">GTK_SCROLL_JUMP</span>, the list
scrolls to the ratio <em class="parameter"><code>position</code></em>: 0 is full left, 1 is full right.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>scroll_type</code></em> :</span></p></td>
<td>the scrolling type.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>the position if <em class="parameter"><code>scroll_type</code></em> is <span class="type">GTK_SCROLL_JUMP</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-scroll-vertical"></a><h3>gtk_list_scroll_vertical ()</h3>
<pre class="programlisting">void                gtk_list_scroll_vertical            (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType">GtkScrollType</a> scroll_type,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"
>gfloat</a> position);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_scroll_vertical</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Scrolls <em class="parameter"><code>list</code></em> vertically. This supposes that the list is packed into a
scrolled window or something similar, and adjustments are well
set. Step and page increment are those from the vertical adjustment
of <em class="parameter"><code>list</code></em>. Backward means up, and forward down. Out of bounds values are
truncated.
<em class="parameter"><code>scroll_type</code></em> may be any valid <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a>. If <em class="parameter"><code>scroll_type</code></em> is
<span class="type">GTK_SCROLL_NONE</span>, nothing is done. If it's <span class="type">GTK_SCROLL_JUMP</span>, the list
scrolls to the ratio <em class="parameter"><code>position</code></em>: 0 is top, 1 is bottom.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>scroll_type</code></em> :</span></p></td>
<td>the scrolling type.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
<td>the position if <em class="parameter"><code>scroll_type</code></em> is <span class="type">GTK_SCROLL_JUMP</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-toggle-add-mode"></a><h3>gtk_list_toggle_add_mode ()</h3>
<pre class="programlisting">void                gtk_list_toggle_add_mode            (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_toggle_add_mode</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Toggles between adding to the selection and beginning a new selection. Only
in <a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-EXTENDED--CAPS"><span class="type">GTK_SELECTION_EXTENDED</span></a>. Useful with <a class="link" href="GtkList.html#gtk-list-extend-selection" title="gtk_list_extend_selection ()"><code class="function">gtk_list_extend_selection()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-toggle-focus-row"></a><h3>gtk_list_toggle_focus_row ()</h3>
<pre class="programlisting">void                gtk_list_toggle_focus_row           (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_toggle_focus_row</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Toggles the focus row. If the focus row is selected, it's
unselected. If the focus row is unselected, it's selected. If the
selection mode of <em class="parameter"><code>list</code></em> is <a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-BROWSE--CAPS"><span class="type">GTK_SELECTION_BROWSE</span></a>, this has no effect,
as the selection is always at the focus row.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-toggle-row"></a><h3>gtk_list_toggle_row ()</h3>
<pre class="programlisting">void                gtk_list_toggle_row                 (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *item);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_toggle_row</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Toggles the child <em class="parameter"><code>item</code></em> of list. If the selection mode of <em class="parameter"><code>list</code></em> is
<a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-BROWSE--CAPS"><span class="type">GTK_SELECTION_BROWSE</span></a>, the item is selected, and the others are
unselected.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>item</code></em> :</span></p></td>
<td>the child to toggle.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-undo-selection"></a><h3>gtk_list_undo_selection ()</h3>
<pre class="programlisting">void                gtk_list_undo_selection             (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_undo_selection</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Restores the selection in the last state, only if selection mode is
<a class="link" href="gtk-Standard-Enumerations.html#GTK-SELECTION-EXTENDED--CAPS"><span class="type">GTK_SELECTION_EXTENDED</span></a>. If this function is called twice, the selection is
cleared. This function sometimes gives stranges "last states".
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-list-end-drag-selection"></a><h3>gtk_list_end_drag_selection ()</h3>
<pre class="programlisting">void                gtk_list_end_drag_selection         (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_list_end_drag_selection</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Stops the drag selection mode and ungrabs the pointer. This has no
effect if a drag selection is not active.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the list widget.
</td>
</tr></tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GtkList.property-details"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="GtkList--selection-mode"></a><h3>The <code class="literal">"selection-mode"</code> property</h3>
<pre class="programlisting">  "selection-mode"           <a class="link" href="gtk-Standard-Enumerations.html#GtkSelectionMode" title="enum GtkSelectionMode">GtkSelectionMode</a>      : Read / Write</pre>
<p></p>
<p>Default value: GTK_SELECTION_NONE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GtkList.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="GtkList-select-child"></a><h3>The <code class="literal">"select-child"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="GtkList.html" title="GtkList">GtkList</a>   *list,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   user_data)      : Run First</pre>
<p>
The child <em class="parameter"><code>widget</code></em> has just been selected.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>the newly selected child.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkList-selection-changed"></a><h3>The <code class="literal">"selection-changed"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="GtkList.html" title="GtkList">GtkList</a> *list,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data)      : Run First</pre>
<p>
The selection of the widget has just changed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkList-unselect-child"></a><h3>The <code class="literal">"unselect-child"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="GtkList.html" title="GtkList">GtkList</a>   *list,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>   user_data)      : Run First</pre>
<p>
The child <em class="parameter"><code>widget</code></em> has just been unselected.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>the newly unselected child.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GtkList.see-also"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a></span></p></td>
<td><p>For functions that apply to every <a class="link" href="GtkContainer.html" title="GtkContainer"><span class="type">GtkContainer</span></a>
(like <a class="link" href="GtkList.html" title="GtkList"><span class="type">GtkList</span></a>).</p></td>
</tr>
<tr>
<td><p><span class="term"><span class="type">GtkListitem</span></span></p></td>
<td><p>Children of a <a class="link" href="GtkList.html" title="GtkList"><span class="type">GtkList</span></a> widget must be of this
type.</p></td>
</tr>
</tbody>
</table></div>
<p>
</p>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.11</div>
</body>
</html>
